ASP.NET Core MVC 跟 ASP.NET MVC 觀念是一致的,使用上也沒有什麼太大的變化。
過往 ASP.NET MVC 把 MVC 及 Web API 的套件分開,但在 ASP.NET Core 中 MVC 及 Web API 用的套件是相同的。
本篇將介紹 ASP.NET Core MVC 設定方式。
同步發佈至個人部落格:
John Wu's Blog - [鐵人賽 Day06] ASP.NET Core 2 系列 - MVC
ASP.NET Core 的 MVC(Model-View-Controller) 架構模式延續 ASP.NET MVC,把網站分成三大元件 Model、View及Controller,相依關係如下圖:
![[鐵人賽 Day06] ASP.NET Core 2 系列 - MVC - 相依關係](https://blog.johnwu.cc/images/i06-2.png)
在 ASP.NET Core 中使用 MVC 或 Web API,需要
Microsoft.AspNetCore.Mvc套件。
ASP.NET Core 2.0 以上版本,預設是參考Microsoft.AspNetCore.All,已經包含Microsoft.AspNetCore.Mvc,所以不用再安裝。
如果是 ASP.NET Core 1.0 的版本,可以透過 .NET Core CLI 在專案資料夾執行安裝指令:
dotnet add package Microsoft.AspNetCore.Mvc
安裝完成後,在 Startup.cs 的 ConfigureServices 加入 MVC 的服務,並在 Configure 對 IApplicationBuilder 使用 UseMvcWithDefaultRoute 方法註冊 MVC 預設路由的 Middleware。如下:
Startup.cs
// ...
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
}
public void Configure(IApplicationBuilder app)
{
app.UseMvcWithDefaultRoute();
}
}
建立一個簡單的 Model 用於 Controller 跟 View 互動。
Models\UserModel.cs
public class UserModel
{
public string Name { get; set; } = "John Wu";
}
在專案目錄下建立一個 Controllers 資料夾,把 Controller 都放這個目錄。
過去 ASP.NET 把 MVC 及 Web API 用的 Controller 分為 Controller 及 ApiController,現在 ASP.NET Core 把兩者合一,不再區分 ApiController。
所以要建立一個類別,名稱後綴 Controller 即可,如下:
Controllers\HomeController.cs
public class HomeController
{
public string Index()
{
return "This is HomeController.Index()";
}
}
但要讓 Controller 跟 View 互動,還是需要繼承 Controller 比較方便,如下:
Controllers\HomeController.cs
public class HomeController : Controller
{
public IActionResult Index()
{
var user = new UserModel();
return View(model: user);
}
}
IActionResult 回傳的方式可以有很多種,透過繼承 Controller 後,就可以使用 Controller 的方法:
View 方法,可以找到該 Controller & Action 對應的 *.cshtml, 並且把 UserModel 傳給 View 使用。Ok、BadRequest、NotFound 等。return BadRequest("Internal Server Error"),會回應 HTTP Status 400 及 Internal Server Error 字串。Redirect、LocalRedirect、RedirectToAction、RedirectToRoute 等。return RedirectToAction("Login", "Authentication"),就會把 Request 轉向到 AuthenticationController 的 Login()。return Json(user),會將物件序列化成 JSON 字串,並在 HTTP Headers 帶上 Content-Type=application/json。View 跟 Controller 有相互的對應關係,預設在 Controller 使用 View 方法回傳結果,會從以下目錄尋找對應的 *.cshtml:
*.cshtml。HomeController.Index(),就會找專案目錄下的 Views\Home\Index.cshtml 檔案。*.cshtml。就會到 Shared 目錄找。HomeController.Index(),就會找專案目錄下的 Views\Shared\Index.cshtml 檔案。Views\Home\Index.cshtml
@model MyWebsite.Models.UserModel
Hello~ 我是 @Model.Name
在 *.cshtml 用 @model 綁定 Model 的型別,才可以使用 @Model 取得 Controller 傳入的物件。
![[鐵人賽 Day06] ASP.NET Core 2 系列 - MVC - 範例結果](https://blog.johnwu.cc/images/i06-1.png)
資料流動畫如下:
![[鐵人賽 Day06] ASP.NET Core 2 系列 - MVC - 資料流](https://blog.johnwu.cc/images/i06-3.gif)
Overview of ASP.NET Core MVC
ASP.NET Core - Setup MVC
在建立 Controllers\HomeController.cs 時,程式碼中的Controller會有紅字產生,當我把資料夾Controllers改為Controller,紅字錯誤就消失了。
請問是文章內文有誤嗎?
沒有錯喔,我資料夾都是用 Controllers,會顯示錯誤,可能是開發工具的問題,如果是用 VSCode 的話,重開 VSCode 應該就會正常了。